Skip to content

docs(behavior-parity): correct stale Tools table + 2026-06 accuracy note#151

Merged
oratis merged 1 commit into
mainfrom
docs/sync-behavior-parity
Jun 3, 2026
Merged

docs(behavior-parity): correct stale Tools table + 2026-06 accuracy note#151
oratis merged 1 commit into
mainfrom
docs/sync-behavior-parity

Conversation

@oratis

@oratis oratis commented Jun 2, 2026

Copy link
Copy Markdown
Owner

Summary

BEHAVIOR_PARITY.md is DeepCode's own Claude Code alignment tracker, and the Tools table had drifted badly: it marked Task, NotebookEdit, AskUserQuestion, EnterPlanMode/ExitPlanMode, EnterWorktree/ExitWorktree, ToolSearch, the seven TASK_TOOLS, and the Cron tools as 🔄 deferred — every one of them is in BUILTIN_TOOLS and shipping (verified against packages/core/src/tools/registry.ts). This flips them to , marks ScheduleWakeup ⚠️ (not a DeepCode tool — it uses Cron instead), fixes the headless-flags row (json-schema + include-partial-messages are implemented in headless.ts), and adds a dated accuracy note so readers don't trust the lagging milestone tags.

Test plan

  • prettier --check docs/BEHAVIOR_PARITY.md — clean (tables re-aligned)
  • Each flipped row verified against registry.ts / headless.ts
  • CI green

Documentation

  • This is the documentation change.

Release notes label

  • release-notes:internal

Related

Part of the Codex/Claude Code/DeepCode capability-alignment review. Companion to #147 (/effort), #148 (-C/--cd), #150 (/diff, /release-notes, /bug). Per-row slash/flag flips for those land as the PRs merge (noted inline).

…cy note

The Tools table marked Task, NotebookEdit, AskUserQuestion, EnterPlanMode /
ExitPlanMode, EnterWorktree / ExitWorktree, ToolSearch, the seven TASK_TOOLS and
the Cron tools as 🔄 deferred — every one of them is in BUILTIN_TOOLS and
shipping. Flip them to ✅ (ScheduleWakeup → ⚠️: not a DeepCode tool; DeepCode
uses CronCreate / `deepcode cron`). Fix the headless flags row: json-schema and
include-partial-messages are implemented in headless.ts, not "parsed only".

Add a dated accuracy note flagging that the remaining milestone tags (M3c/M8/…)
lag the code, and listing this alignment batch's additions (-C/--cd, /diff,
/release-notes, /bug, the /effort SSOT fix).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@oratis oratis merged commit 91817ae into main Jun 3, 2026
3 checks passed
@oratis oratis deleted the docs/sync-behavior-parity branch June 3, 2026 17:02
oratis added a commit that referenced this pull request Jun 4, 2026
…code (#154)

* docs(behavior-parity): audit slash-command + CLI-flag tables against code

Reconcile docs/BEHAVIOR_PARITY.md with the actual source. Verified every row
in the Slash-commands, CLI-flags, and Tools tables by grepping the code rather
than trusting the doc.

Slash commands (apps/cli/src/commands.ts BUILTIN_COMMANDS):
- /init  🔄 → ✅  — runInitFlow is a real 3-phase REPL flow (scan → draft →
  approve-write AGENTS.md), wired in repl.ts; no longer a stub.
- /bug  ✗ → ✅  and  /release-notes  ✗ → ✅  — both registered since PR #150.
- /upgrade  ✓/🟡 → ✗/🔄  — there is no /upgrade slash command; it is the
  `deepcode upgrade` CLI subcommand (cli.ts) that prints an upgrade hint.
- add missing rows: /diff (✅, PR #150) and /keybindings (🆕, DeepCode-only).
- /effort wording: CLI prints the EFFORT_PARAMS-derived tier table (PR #147).
- header count ~20 → ~28 shipped.
- genuinely-missing commands kept 🔄 (/btw /recap /voice /teleport /desktop
  /background /batch /tasks /plan /login /logout /pr_comments /terminal-setup
  /privacy-settings /migrate-installer); skill-backed kept 🟡 (/review,
  /security-review, /schedule, /loop — skills confirmed under packages/core/skills).

CLI flags (apps/cli/src/parse-args.ts + cli.ts):
- split `--mode` / `--permission-mode`: the latter is parsed + validated but
  never consumed (cli.ts forwards only args.mode) → 🔄 not wired.
- add `-C` / `--cd <dir>` (✅, wired via process.chdir in cli.ts, PR #148).

Tools table (de-staled by PR #151) re-verified row-by-row — all markers hold:
TaskTool + ctx.runSubAgent (agent.ts), all 7 TASK_TOOLS, NotebookEdit,
AskUserQuestion, Enter/ExitPlanMode, Enter/ExitWorktree, ToolSearch, Cron*;
ScheduleWakeup correctly ⚠️ (not a tool — use CronCreate).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

* docs(behavior-parity): fix /keybindings — it's a Claude Code built-in, not DeepCode-only

Verified against Claude Code's built-in command set: /keybindings ships in
Claude Code ("open or create your keybindings config file"). DeepCode's
/keybindings only lists bindings (read-only; edit ~/.deepcode/keybindings.json
by hand), so mark it ✓ / ✓ (read-only) / 🟡 — same shape as /config and
/permissions — rather than 🆕 DeepCode-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: t <t@t>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant